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REFERENCE GUIDE NOTATIONS AND 
FORMAT CONVENTIONS 

A standard scheme for presenting the general format of BASIC language statements is employed in 
this reference guide. The capitalization, punctuation and other conventions are listed below: 

[ ] 



Brackets indicate that the enclosed items 
are optional. Brackets do not appear in 
the actual statements. 

{ } Braces indicate that a choice of one of 
the enclosed items is to be made. Braces 
do not appear in the actual statements. 

. . . Ellipses indicate that the preceding item 
may be repeated. Ellipses do not appear 
in the actual statements. 

Italics Italics indicate generic terms. The pro- 
grammer must supply the actual value or 



wording required. See Generic Terms and 
Abbreviations. 

Line number A line number is implied for all 
BASIC language statements. 

Punctuation All punctuation characters, in- 
cluding commas, semicolons, colons, 
quotation marks and parentheses, must 
appear as indicated. 

UPPER CASE Upper case letters and words 
must appear exactly as indicated. 



GENERIC TERMS AND ABBREVIATIONS 



emdno — The number that stands for the par- 
ticular command to be performed. 

constant — Actual value BASIC uses during 
program execiition. May be string or 
numeric. 

constants — String constant only. 

cferlce — Numeric value associated with 
logical device assigned during an open 
command. 

dummy — Dummy argument or zero. 

arror numbar — numerical code associated 
with an error condition. 

axpf axp2 — Expressions that are evaluated. 

axpr — Numeric or string expression. 

axpr$ — Any valid string constant, variable or 
expression. 

axprnm — Any numeric constant, variable or 
expression. 

axprnm^fo — Any integer numeric constant, 
variable or expression. 



filanum — The file number assigned to a file by 
the OPEN statement. 

fllaspac — File specification of a program or 
data files to be loaded. See File Naming 
Convention. 

format — Format applicable to all BASIC 
versions. 

format o — Format applicable to Disk Operating 
System (DOS). 

Una — A BASIC statement line number. 

linai — The ith line of a BASIC program. 

mamadr — Memory address. 

sub — Subscript. 

jf coord — X coordinate screen point. 

war — Numeric or string variable. 

varnm — Numeric variable. 

var$ — String variable. 

If coord — y coordinate screen point. 



BASIC OPERATORS 



OPERATION 



OPERATOR 



SAMPLE 



ARITHMETIC 



Exponentiation 
Negation 
Multiplication 
Division 
Addition 
Subtraction 
RELATIONAL 



/ 

+ 



A A B 


-A 


A * B 


A/B 


A + B 


A - B 


A = B 


A <> B 


A < B 


A > B 


A < = B 


A > = B 



Equal 
Not Equal 
Less than 
Greater than 
Less than or equal 
Greater than or equal 



< > 
< 
> 

< = 
> = 



ATARI® is a reaistered trademark of Atpiri Inn 



BASIC OPERATORS (cont.) 


OPERATION 


OPERATOR 


SAMPLE 


LOGICAL 


Logical complement 

Conjunction 

Disjunction 


NOT 

AND 

OR 


A NOT B 
AANDB 
A ORB 



FILE NAMING CONVENTION 



fflespec — File specification is a string 
expression. 

format: device: filename 
wliere: device is a device name from the 
following list: 

K Keyboard. Input only. 

P Line Printer. Output only. 

C Cassette. Input/Output only. 

D Disk, if only one. Input/Output. 

Dfi Disk 1-4, if multiple. Input/Output. 

E Screen editor. Input/Output. 

S TV monitor. Input/Output. 

R RS232 interface, modem or plotter. 
Input/Output. 

NOTE: Colon (:) must be included between 
device and file name. 



illmnamm — is composed of two parts: 

name. extension. Tine name portion may be 
up to 8 characters in length, consisting of 
characters or letters. It must begin with an 
alphabetic character. The extension is op- 
tional. May be up to 3 characters; for 
example: 

BAS = Basic Program 

DAT = Data File 

BIN = Binary File 

LCD = Load File 

007 = Seventh Version 



SYSTEM COMMANDS 



BYE (B.J— Exits from BASIC and returns to the 
resident operating system (DOS) or con- 
sole processor (MEMO PAD). 

format: BYE 

CLOAD — Loads a token ized program from 
cassette into RAM. 

format: CLOAD 

COHT — Resumes program execution after it 
has been stopped by pressing the break 
key or by encountering a STOP or END 
command. 

format: CONT 

CSAVE (CS.) — Outputs program in tokenized 
form 

from RAM to cassette. 

format: CSAVE 
DOS — Displays DOS menu. 

formatp: DOS 
DOS — Displays DOS menu. 

formato: DOS 

ENTER (E.) — Inputs data or program in pure 
(untokenized) form. 

format: ENTER fiiespec 



LIST (L.) — Lists the program currently in 
memory on the monitor screen or on the 
device specified by fiiespec. 

format: LIST [fiiespec] [ ,(from)//ne] 

[ ,(to)//ne] 

LOAD (LO.) — Loads a program in tokenized 
form from the device specified into 
memory. 

format: LOAD fiiespec 

NEW — Deletes old program and allows user to 
enter new program. 

format: NEW 

RUN — Begins execution of a program current- 
ly in memory or loads and executes a 
specified file. Initializes variables and un- 
dimensions arrays and strings. 

format: RUN [f/7espec] 

SAVE (S.) — Saves a BASIC program in 
tokenized form on the device specified. 

format: SAVE fiiespec 



BASIC LANGUAGE STATEMENTS 



AUDIO STATEMENTS 



SOUND (SO.)— Plays a tone through the TV 
speaker until the next SOUND statement 
is encountered. Parameters control voice 



registers for pitch, distortion and volume, 
format: SOUND var^ var2 var^ var4 



SOUND PARAMETERS 



RARAMETER 


CONTROL 


RANGE 


REMARKS 


var^ 


VOICE REGISTER 


0-3 


Each voice requires separate 
sound statement. 


var2 


SOUND PITCH 


0-255 


The larger the number, the 
lower the pitch. See chart. 


vara 


DISTORTION 


j2f-14 


Varies: 10 = pure tone, 
12 = buzzer. 


var4 


VOLUME CONTROL 


1-15 


The larger the number, the 
greater the volume. 



PITCH VALUES (vars) FOR THE MUSICAL SCALE 



NOTE 



FREQ 





II 




BRANCHINQ 



GOSUB (QOS.) — Causes a branch to the 
subroutine starting at the specified line. 

format: GOSUB line 

GOTO (G.) — Causes an unconditional branch 
to a specified line. 

format: GOTO line 

IF - THEN — Used to cause a conditional 

branch or to execute other statements on 
the same line (only if first expression is 
true). 

format: ( THEN EXPR [-.expr] . 

\f expr < THEN line 
I GOTO line 

ON-GOSUB — Causes a conditional subroutine 
call depending upon the current or com- 



puted value of the expressions. 

format: ON exprnm GOSUB line [, line]. . 

ON-GOTO — Causes a conditional branch 
based upon the current or computed 
value of the expression. 

format: ON exprnm GOTO line [, line]. . . 

POP — Removes the loop variable from the 
GOSUB or FOR/NEXT stack. Use when 
exiting a loop in other than norma! 
RETURN or NEXT manner. 

format: POP 

RETURN (RET.) — Causes a branch from a 
subroutine to the statement immediately 
following the calling GOSUB statement. 

format: RETURN 



ERROR DETERMINATION AND CONTROL 



TRAP (T.y — Takes control of a program in the 
event of an INPUT error and directs ex- 
ecution to a specific line. Without a TRAP 
the program halts and displays an error 
code on the screen. 



format: TRAP line 
to reset: TRAP 40000 
to examine: 

errornunnber = PEEK (195) 

line = 256 * PEEK (187) + PEEK (186) 



PROCESSING STATEMENTS 



CLR — The opposite of DIM. Un-dimensions all 

strings and matrices. 

format: CLR 
COM— Same as DIM. 
DATA (D.) — Creates a list of numeric and 

string constants to be assigned to 

variables through the use of a READ 

statement. 

format: DATA const [, const]. . . 



DIM — ^i^eserves space in memory for arrays, 
matrices and strings, all of which must be 
dimensioned prior to use. 

format: DIM var{sub)[, var{sub)] . 

END — Stops program execution, closes files 
and turns off sound(s). Program can be re- 
started with CONT. May be used several 
times in program. 

format: END 



FOR (F.J — Initiates a loop that repeats execu- 
tion of all instructions until the NEXT state- 
ment is reached. Exits when varnm equals 
expmm2 . 

fornnat: FOR varnm = exprnm^, 
TO expmm2 [STEP expmrn^] 

LET — Assigns a value to the specified 
variable. LET may be omitted without 
penalty. 

format: [LET] var = exprnm 

NEXT (N.) — Terminates a loop initiated by a 
FOR statement. All loops execute at least 
once. 

format: NEXT [uarnm] [, varnm]. . . 

PADDLE — Returns the position of paddle 
game controller (n). Return value ranges 
from 1 to 228, increasing as l<nob rotates 
counterclockwise, 
example: IF PADDLE {varnm) = 

' GOTO ) 
exprnm r 

PTRIG — Returns the status of the trigger 
button on game controller {n). Return 
value equals zero when pressed, 
example: IF PTRIG {varnm) = 

' GOTO ) 
exprnm i 

READ — Reads the next item in the DATA list 
and assigns it to the specified variable. 

format: READ varnm ^ LuammpJ. . . 
REM (R.) — Permits remarks to be inserted in a 
or (.sp) program. Not executed. 

format: REM remark 



constant J HEH 



constant THEN 



RESTORE (RES.)— Permits DATA statements 
to be reread from a specific line. 

format: RESTORE [line] 
STICK — Returns the position {see diagram) of 
a joy stick controller (n). 
example: IF STICK (varnm) 

GOTO 
exprnm 



constant THEN 



^r\ \vaiitnif — 

i GOTO \ 
( exprnm j 




STICK RETURN VALUES 

STRIG — Returns if stick trigger pressed; 1 if 
not pressed. 

example: IF STRIG (varnm) = 
GOTO 



co/isfa/if THEN 



( GOTO ) 
I exprnm j 



STOP — Stops program execution but does not 
close files or turn off sound. 

format: STOP 



INPUT/OUTPUT CONTROL 



CLOSE (CL.) — Closes files that were 

previously opened with a specified file 

number. 

format: CLOSE menum 

GET— Inputs a single byte of data from a 
specified device, 
format: GET §filenum, exprnm 

INPUT (I.) — Requests input from the keyboard 
during program execution. Execution con- 
tinues after RETURN key is pressed. 

format: INPUT \ ^^P^^ i 

I exprnm \ [ , ] • • . 

LPRINT (LP.} — Prints data on the line printer. 
Requires no open or close statements. 

expr$ I 
exprnm ) 



format: LPRINT 



[], \ expr . J 



expr . 

NOTE (NO.J— Used in conjunction with POINT 
when writing DOS files. First variable 
specifies sector number and second 
specifies byte within sector. 

formato: NOTE device, varnm, varnm 

OPEN (O.) — Opens a specified file for input or 
output operation. 

format: OPEN filespec 



POINT (P.) — Used when reading DOS files in- 
to RAM. First variable specifies sector 
number and second specifies byte within 
sector to begin reading. Provides pseudo 
random access. 

formatp: POINT device, varnm, varnm 

PRINT (PR.)— Displays output on the TV 
or (?) monitor or any other specified 

output device. 

format: PRINT [ffilenum'] 



\ expr$ I 
I exprnm \ 



[:] 



PUT — Outputs a single byte of data to a 
specified device. 

format: PUT ^fitenum, exprnm 

STATUS (ST.)— Calls the status routine for a 
specified device. The status (error 
message) is stored in the specified 
variable. 

format: STATUS ^itenum, varnm 

XIO (X.) — General purpose I/O statement that 
executes any input/output operation 
depending on the value of cmdno. 

format: XIO cmdno, ^filenum, exprnm^, 
exprnm 2, filespec 



XIO COMMAND TABLE 



cmdno 


OPERATION 


cmdno 


OPERATION 


3 


Open 


18 


Fill 


5 


Get Record 


32 


Rename File 


7 


Get Characters 


33 


Delete File 


9 


Put Record 


35 


Lock File 


11 


Put Characters 


36 


Unlock File 


12 


Close File 


37 


Point 


13 


Status Request 


38 


Note 


17 


Draw Line 


254 


Fornnat 



exprnm^ and exprnm2 depend on device. Generally dummy. 



GRAPHICS AND VIDEO CONTROL 



COLOR (C.J — Used in text mode 0-2 in con- 
junction with PLOT to generate a 
character on the screen. 



format: COLOR expmm 



COLOR (C-J — Used in graphics mode 3-8 in 
conjunction with SETCOLOR to determine 
the color of each PIXEL, 
format: COLOR expmm 



COLUMNS 



SCREEN FORMATS 



ORAPHICS MODE 
MODE TYPE 


PIXEL 
SIZE COLUMNS 


ROWS ROWS 
(SPLIT) (FULL)* 


NUMBER 
COLORS 


BYTES 

(SPLIT) 

REQUIRED 


BYTES 

(FULL) 

REQUIRED 





Text 


1W; 1H 


40 


— 


24 


r/2 


992 


— 


1 


Text 


2W, 1H 


20 


20 


24 


5 


674 


672 


2 


Text 


2W, 2H 


20 


10 


12 


5 


424 


420 


3 


Graphics 


1W, 1H 


40 


20 


24 


4 


434 


432 


4 


Graphics 


1/2W, 1/2H 


80 


40 


48 


2 


694 


696 


5 


Graphics 


1/2W, 1/2H 


80 


40 


48 


4 


1174 


1176 


6 


Graphics 


1/2W, 1/2H 


160 


80 


96 


2 


2174 


2184 


7 


Graphics 


1/4W, 1/4H 


160 


80 


96 


4 


4190 


4200 


8 


Graphics 


1/8W, 1/8H 


320 


160 


192 


^V2 


8112 


8138 


9** 


Graphics 


1/2W, 1/8H 


80 


— 


192 


1 


8112 


8138 


10** 


Graphics 


1/2W, 1/8H 


80 


— 


192 


9 


8112 


8138 


11** 


Graphics 


1/2W, 1/8H 


80 


— 


192 


16 


8112 


8138 



*Add + 16 to mode number for full screen (no text window). 
**Requires GTIA chip. *? 



DRAWTO (DR.) — Draws a straight line be- 
tween a PLOTed point and a specified 
point. 

format; DRAWTO xcoord, ycoord 

GRAPHICS (OR,)— Specifies which of the 
twelve graphics modes is to be used. 
GR.O clears screen. 



format: GRAPHICS 



( constant } 
i vamm ) 



LOCATE (LOC.) — Positions the invisible 
graphics cursor to specified location in 
graphics window and retrieves data stored 
there. 

format: LOCATE xcoord, ycoord, var 

PLOT (PL.) — Causes a single point to be 
plotted at the specified location. 

format: PLOT xcoord, ycoord 



POSITION (POS.J— Sets the cursor to the 
specified screen position. 

format: POSITION xcoord, ycoord 

SETCOLOR (SE.) — Selects a particular color 
hue and luminance and places it in the 
specified color register. 

format: SETCOLR exprnm^, expmmj, 
exprnm^ 

where: 

exprnm^ = color register 0-4, depend- 
ing on mode. 

exprnm2 - color hue 0-15 (see HUE 
table). 

exprnm^ = color luminance 0-14, the 
higher the brighter. 



Copyright © 1982 by John Wiley and Sons, Inc. ISBN 471-87041-2 



HUE TABLE 



0xprnm2 


COLOR HUE 


expmmg 


COLOR HUE 





Gray 


8 


Blue 


1 


Gold 


9 


Light Blue 


2 


Orange 


10 


Turquoise 


3 


Red-Orange 


11 


Green-Blue 


4 


Pink 


12 


Green 


5 


Purple 


13 


Yellow-Green 


6 


Purple-Blue 


14 


Orange-Green 


7 


Blue 


15 


Light Orange 



GRAPHICS MODE AHD COLOR COMBIHATIOHS 



TEXT 
MODE 


COLOR 
VARIABLE 


SETCOLOR 
REGISTER 


DEFAULT 
HUE 


DEFAULT 
LUMINANCE 


DERIVED 
COLOR 


0& 

Text 

Window 


Actual 

Text 

Character 


1 
2 

4 


9 
9 




8 
4 



Light Blue 
Dark Blue 
Black 


1&2 







2 


8 


Orange 






1 
2 
3 

4 


12 
9 
4 



10 
4 
6 



Light Green 
Dark Blue 
Red 
Black 


GRAPHIC 
MODE 


COLOR 
VARIABLE 


SETCOLOR 
REGISTER 


DEFAULT 
HUE 


DEFAULT 
LUMINANCE 


DERIVED 
COLOR 


3,5,7 


1 
2 
3 




1 
2 
4 


2 

12 

9 




8 

10 
4 



Orange 
Light Green 
Dark Blue 
Black 


4&6 


1 





4 


2 



8 



Orange 

Black 


8 


1 





1 
2 
4 


9 
9 



8 

4 



Light Blue 
Dark Blue 
Black 



XIO {X.\ — A special application of the general 
XIO statennent used to "paint" colors be- 
tween plotted points and lines. Must first 



POKE 765 with color variable number. 
format; XIO 18, #6,12, dummy, "S:" 



BASIC FUNCTIONS 

FUNCTION FORMAT AND DESCRIPTION 



ABS {9xprnm\ — Returns the absolute value 
of the expression. 

ADR (yar$) — Returns memory address of a 
string. 

ASC lmxpr$\ — Returns numeric value of a 
single string character. 

ATN {mxprnm} — Returns the arctangent in 
radians or degrees. 

CHR$ (exprfim) — Converts an ASCII code to 
its character equivalent. 

CLOQ {exprnm} — Returns the common (base 
10) logarithm of an expression. 

COS {mxprnm} — Returns the cosine of an 
angle expressed in radians or degrees. 



DEO — Tells computer to perform trigonometric 
functions in degrees instead of radians 
(default radians). 

EXP {0xprnm\ — Returns the base of the 
natural logarithm (e) raised to the specific 
power. 

PRE {dummrl — Returns the number of bytes 
in memory not used by BASIC. 

INT {mxprnml — Returns the largest integer 
which is less than or equal to the exprnm. 

LEN lmxpr$) — Returns the length of the 
specified string in bytes. 

LOG [mxprnm] — Returns the natural log- 
arithm of the specified number. 



PEEK {memadry — Returns the decimal value 

of the contents of the specified mennory 
location. 

POKE memadr, exprnm— Writes the value 
of the specified expression into the in- 
dicated nriemory address. 

RAD— Tells the connputer to perform trig- 
onometric functions in radians instead of 
degrees (default). 

RND {dummyl — Returns a random number 
between and 1 . 

SGN {exprnm\ — Returns +1 if expmrn is 
positive, if zero, -1 if negative. 



SIN [Bxprnm\ — Returns the sine of an angle 
expressed in radians or degrees. 

SQR {exprnm} — Returns the square root of 
exprnm, 

STR$ {exprnm} — Returns the string value of 
the numeric expression. 

USR [exprnm [, exprnm} J— Executes a 
machine language subroutine. 

VAL {exprnm$\ — Returns the equivalent 
numeric value of a string. 



KEY COMBINATIONS 



ESC CTRL CLEAR— Clears the screen dur- 
ing the execution of a program with 
PRINT. 

SHIFT SET-CLR TAB— Sets a tab. Default 7, 
15,23, 31, 39. 

CTRL SET-CLR TAB— Clears a tab. 

SHIFT INSERT— Inserts a line. 
CTRL INSERT — Inserts a character. 
SHIFT DELETE— Deletes a line. 
CTRL DELETE— Deletes a character. 



CTRL CLEAR— Clears screen and homes 

cursor. 

SHIFT CAPSILOWR— Restores characters 
to upper case. Lower case set without 
shift. 



-Moves cursor one physical 



CTRL CURSOR- 

line. 

CTRL-1 — Temporarily stops and restarts 
display without breaking program. 

CTRL-3 — Use with screen editor and disk to 
dump file. 





BASIC ERROR MESSAGES 


NUMBER 


MESSAGE 


NUMBER 


MESSAGE 


2 


Memory Insufficient 


134 


Bad tOCB Number 


3 


Value Error 


135 


lOCB Read Only Device 


4 


Too Many Variables 


136 


EOF not expected 


5 


String Length Error 


137 


Truncated Record 


6 


Out of Data 


138 


Device Timeout 


7 


Number greater than 32767 


139 


Device NAK 


8 


Input Statement Error 


140 


Serial Bus Frame Error 


9 


Array or String Dim Error 


141 


Cursor Out of Range 


10 


Argument Stack Overflow 


142 


Serial Bus Overrun 


11 


Floating Point Under/Overflow 


143 


Serial Bus Checksum 


12 


Line Not Found 


144 


Device Error 


13 


No Matching FOR Statement 


145 


ReadA/Vrite Compare 


14 


Line Too Long 


146 


Invalid Function 


15 


GOSUB or FOR Line Deleted 


147 


Insufficient RAM 


16 


Return Error 


160 


Drive Number Error 


17 


Syntax Error 


161 


Too Many OPEN Files 


18 


Invalid String Error 


162 


Disk Full 


19 


Load Program Too Large 


163 


Unrecoverable I/O Error 


20 


Device No. Larger Than 7 


164 


File Number Mismatch 


21 


Load File Error 


165 


File Name Error 


128 


Break Abort 


166 


Point Data Length Error 


129 


lOCB Already Open 


. 167 


File Locked 


130 


Nonexistent Device 


168 


Command Invalid 


131 


IOCS Write Only Device 


169 


Directory Full 


132 


Invalid Command 


170 


File Not Found 


133 


Device or File Not Open 


171 


Point Invalid 



